package com.expert.miniapp.dao;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 实验室数据访问层接口
 * 提供实验室相关的数据库操作方法
 */
@Mapper
public interface LaboratoryMapper {

    /**
     * 根据实验室ID查询详情
     * @param labId 实验室ID
     * @return 实验室详情，如果不存在则返回null
     */
    Laboratory findById(@Param("labId") String labId);

    /**
     * 根据实验室分类查询实验室列表
     * @param category 实验室分类
     * @return 符合分类条件的实验室列表
     */
    List<Laboratory> findByCategory(@Param("category") String category);

    /**
     * 查询所有实验室
     * @return 所有实验室列表
     */
    List<Laboratory> findAll();

    /**
     * 按权重排序查询实验室列表（用于推荐）
     * @return 按权重随机排序的实验室列表
     */
    List<Laboratory> findByWeightOrder();

    /**
     * 模糊搜索实验室
     * @param keyword 搜索关键词
     * @return 匹配关键词的实验室列表
     */
    List<Laboratory> searchByKeyword(@Param("keyword") String keyword);

    /**
     * 根据分类统计实验室数量
     * @param category 分类名称（如："人工智能"）
     * @return 包含该分类的实验室数量
     */
    Integer countByCategory(@Param("category") String category);
}